home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / UTILREEN / PRNTUTIL.LZH / XPS.DOC < prev   
Text File  |  1988-03-29  |  10KB  |  269 lines
  1.                             eXtended PrintScreen 
  2.  
  3.                                  Version 1.2
  4.  
  5.                                Copyright 1988    
  6.                              Kenneth D. Whitney
  7.                              All Rights Reserved
  8.  
  9. WHAT DOES IT DO?
  10.  
  11.      eXtended PrintScreen makes the PrintScreen function more
  12.  
  13.      *** Intelligent.  XPS formats text into pages.
  14.  
  15.      *** Efficient.    XPS prints screen images in compressed mode at 75 
  16.                        lines per page.
  17.  
  18.      *** Flexible.     XPS allows portions of display text to be printed.  
  19.                        You select the PrintScreen window.
  20.  
  21. USING XPS
  22.  
  23. System Requirements:
  24.  
  25.      -- IBM PC,XT,AT, or close compatible.
  26.      -- A dot-matrix printer attached to LPT1:.
  27.  
  28.  
  29. Starting XPS:
  30.  
  31.      XPS is a memory-resident (TSR) program.  Simply type
  32.  
  33.      XPS 
  34.      
  35.      at the DOS prompt.
  36.  
  37.      To run XPS's installation program, type
  38.  
  39.      XPS -i  
  40.  
  41.      (See INSTALLATION below)
  42.  
  43.  
  44. Controlling XPS:
  45.  
  46.      After XPS is loaded, the following key combinations are used to 
  47.      activate XPS's features.
  48.  
  49.      LEFT-SHIFT + PrtScr   
  50.      
  51.      Do full-display printscreen.  This feature is closest to a "stock" 
  52.      PrintScreen.  The entire display is copied, line by line, to the 
  53.      printer.  With XPS, however, the text is sent to the printer in 
  54.      compressed mode at 75 lines/page.  After printing 75 lines, XPS will 
  55.      send a form feed to the printer.  XPS keeps a running total of lines 
  56.      sent to the printer, so each time you activate XPS it "remembers" how 
  57.      many lines have been printed.  If you wish to clear XPS's line 
  58.      counter, use the reset feature described below.
  59.  
  60.      RIGHT-SHIFT + PrtScr  
  61.      
  62.      Selected area printscreen.  Allows any area of the display to be 
  63.      printed.  The print window is indicated by a > and < arrow.  All text 
  64.      under and between the arrows will be printed.  Thus the line
  65.  
  66.           The quick brown fox jumped over the lazy dog
  67.                                                                    
  68.      would all be printed if the arrows were positioned as follows:
  69.  
  70.           >he quick brown fox jumped over the lazy do<
  71.      
  72.      The XPS window can be adjusted by using the numeric keypad.  
  73.  
  74.          Up Arrow      - Decrease rows
  75.          Down Arrow    - Increase rows
  76.          Left Arrow    - Decrease columns
  77.          Right Arrow   - Increase columns
  78.          PgUp          - Move window up
  79.          PgDn          - Move window down
  80.          Home          - Move window left
  81.          End           - Move window right
  82.          Enter         - Print window
  83.          Esc           - Exit XPS
  84.  
  85.  
  86.      LEFT-SHIFT + RIGHT-SHIFT + PrtScr
  87.  
  88.      Reset XPS.  This key combination resets XPS's line counter and beeps 
  89.      the speaker.
  90.  
  91. INSTALLATION  (or, Everything You Never Wanted To Know About Printers)
  92.  
  93.      Computers send bytes to printers.  Printers print bytes.  So far, so 
  94.      good.  Unfortunately, different bytes mean different things to different 
  95.      printers.  When XPS sends control codes to your printer, your printer 
  96.      better understand XPS, or printed garbage will result. 
  97.  
  98.      Fortunately for those who don't have my kind of printer (IBM Graphics), 
  99.      XPS now offers a flexible installation for just about any printer.  
  100.      With installation, you to determine the control codes that XPS sends to 
  101.      your printer, and, to some extent, when these codes are sent.  
  102.      Unfortunately, determining which codes to use is not always obvious.  
  103.      Take a few moments and study your printer's manual, then plunge on in. 
  104.  
  105.      XPS uses three different control strings: 
  106.  
  107.        1) An initialization string,
  108.        2) A line-control string, and
  109.        3) A reset string.
  110.  
  111.      These strings are all optional, but obviously in order for XPS to do 
  112.      anything useful it must use one or more control strings.  
  113.  
  114.      XPS installation is simple.  Just type
  115.  
  116.      XPS -i
  117.  
  118.      at the DOS prompt.  The installation menu will appear, and you will be 
  119.      prompted for each control string.  Type in each control string using the 
  120.      following format: 
  121.  
  122.      \n\n\n\n
  123.  
  124.      where n = a decimal control code with values ranging from 1 to 255.
  125.  
  126.      Each control character is preceded by a '\', and 
  127.      
  128.                               -- this is important--
  129.  
  130.                    EACH CONTROL CODE MUST BE ENTERED IN DECIMAL 
  131.  
  132.      XPS does no error-checking on the data entered, so it is up to you to 
  133.      ensure that your codes are correctly entered in the proper format.
  134.  
  135.      The best way to illustrate installation is to use an example from my IBM 
  136.      Graphics printer. 
  137.  
  138.      My Initialization string looks like this (in XPS's format):
  139.  
  140.         \015\027\051\030
  141.  
  142.      This string sets the printer to condensed mode and changes the linefeed 
  143.      to 30/216th of an inch (roughly 75 lines/page). 
  144.  
  145.      My Line Control string looks like this:
  146.  
  147.         \013\010
  148.  
  149.      Why a carriage return (013) and linefeed (010) for the line control 
  150.      string?  Because XPS DOES NOT explicitly send these codes for a new 
  151.      line.  If you need them, you must install them. 
  152.  
  153.      My reset string looks like this:
  154.  
  155.         \018\027\050
  156.  
  157.      This cancels compressed mode and restores default line spacing.  
  158.  
  159.      (By the way, the three-digit format is not necessary.  Thus, \15 and \015 
  160.      are equivalent).
  161.      
  162.      When are these strings sent to the printer? 
  163.  
  164.      Initialization -- Just before XPS begins printing text.
  165.      Line Control   -- After each line is sent to the printer.
  166.      Reset          -- When XPS is finished printing a screen or window.
  167.  
  168.      These three printer control strings permit the same task to be 
  169.      accomplished in several ways.  On my printer, for example, the 
  170.      following control strings do the same job as the ones listed above. 
  171.  
  172.      Initialization: \015               (compressed)
  173.      Line Control  : \27\74\30          (one-time 30/216th linefeed)
  174.      Reset         : \018               (cancel compressed)
  175.  
  176.      Note that this line control string does not properly handle IBM line 
  177.      drawing characters.  Why?  I don't know. 
  178.  
  179.      All of this fussing with control codes is a pain.  What is obviously 
  180.      needed is a industry-standard set of codes that ALL printers respond 
  181.      to.  Unfortunately, EPSON, the quasi-official standard has not stuck to 
  182.      the straight an narrow and keeps changing their codes.  For example, on 
  183.      my IBM Graphics priner (read EPSON MX-80), the codes for a one-time 
  184.      line feed of 30/216ths of an inch are 
  185.      
  186.      \027\074\030
  187.      
  188.      Use the above code on an LQ-series printer and you get a 30/180th of an 
  189.      inch one-time line feed.  And so it goes with other printer 
  190.      manufacturers as well.  If you don't like having to mess with printer 
  191.      drivers and installation, write your printer's manufacturer a letter of 
  192.      complaint. 
  193.  
  194.      You are also prompted for your printer's name which will be displayed 
  195.      when XPS is loaded into memory, but the printer name serves no 
  196.      additional function.  Type in your name if you prefer. 
  197.  
  198.      XPS installation modifies the copy of XPS.COM in the default directory.  
  199.      Therefore, always run installation on a backup copy of XPS.COM!
  200.  
  201. NOTES:
  202.  
  203.      XPS will not operate in graphics modes.  Pressing any Shift-PrintScreen 
  204.      combination will cause the normal PrintScreen to be invoked.  Invoking 
  205.      PrintScreen in graphics modes also resets XPS's line counter. 
  206.      
  207.      XPS will recognize 40-column text modes (does anyone still use these?) 
  208.      and set its defaults accordingly. 
  209.      
  210.      XPS currently does not recognize or adjust for >25 row displays.  
  211.  
  212.      
  213.      
  214.                                  DISCLAIMER
  215.  
  216.    eXtended PrintScreen is provided as is WITH NO WARRANTIES OF ANY KIND.
  217.  
  218.  
  219.                            eXtended PrintScreen is
  220.  
  221.                       Copyright 1988 Kenneth D. Whitney
  222.                              All Rights Reserved
  223.  
  224.  
  225.                                M A I L W A R E
  226.  
  227. eXtended PrintScreen may be freely copied, placed on public and private 
  228. bulletin boards, and shared.  IT MAY NOT BE SOLD.  eXtended PrintScreen may 
  229. only be distributed as a package which includes the following three files: 
  230.          
  231.                      XPS.COM     XPS.DOC     MAILWARE.FRM
  232.  
  233. XPS must not be distributed as separate files or in modified form.  
  234.  
  235. =============================================================================
  236.                                If you find that 
  237.  
  238.                              eXtended PrintScreen 
  239.  
  240.                               is a useful program  
  241.                              your contribution of 
  242.  
  243.                                     $10.00 
  244.  
  245.                              will be appreciated.  
  246. ============================================================================= 
  247.  
  248. Please take a minute to fill out and mail the questionnaire included in 
  249. MAILWARE.FRM, whether or not you decide to support XPS with a contribution.    
  250. By registering your copy of XPS in this fashion, you will be providing 
  251. important feedback to the author (me).  In return for your time and stamp, you 
  252. will, from time to time if you so indicate on the form, receive announcements 
  253. of new software, updates, and special offers. 
  254.  
  255. Use the MAILWARE.FRM for suggestions to improve the program, to report bugs, 
  256. to suggest new programs, etc.  I will make every effort to make improvements 
  257. and fix bugs, so by all means, let me hear from you. 
  258.  
  259. (XPS's installation program was written in response to MAILWARE suggestions.  
  260. My thanks to all who offered their input.) 
  261.   
  262.  
  263.                              Kenneth D. Whitney
  264.                             303 Welch Avenue #311
  265.                               Ames, Iowa 50010
  266.  
  267. XPS was assembled with Eric Isaacson's A86 Assembler.  
  268.  
  269.